<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>gnome-util</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GNOME Library Reference Manual">
<link rel="up" href="ch04.html" title="Miscellaneous">
<link rel="prev" href="ch04.html" title="Miscellaneous">
<link rel="next" href="libgnome-gnome-sound.html" title="gnome-sound">
<meta name="generator" content="GTK-Doc V1.16 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="ch04.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ch04.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GNOME Library Reference Manual</th>
<td><a accesskey="n" href="libgnome-gnome-sound.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#libgnome-gnome-util.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#libgnome-gnome-util.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="libgnome-gnome-util"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="libgnome-gnome-util.top_of_page"></a>gnome-util</span></h2>
<p>gnome-util — Miscellaneous utility functions.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="libgnome-gnome-util.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;libgnome/libgnome.h&gt;

#define             <a class="link" href="libgnome-gnome-util.html#gnome-is-program-in-path" title="gnome_is_program_in_path()">gnome_is_program_in_path</a>            (program)
const <span class="returnvalue">char</span> *        <a class="link" href="libgnome-gnome-util.html#g-extension-pointer" title="g_extension_pointer ()">g_extension_pointer</a>                 (<em class="parameter"><code>const <span class="type">char</span> *path</code></em>);
#define             <a class="link" href="libgnome-gnome-util.html#gnome-util-prepend-user-home" title="gnome_util_prepend_user_home()">gnome_util_prepend_user_home</a>        (x)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-util-home-file" title="gnome_util_home_file()">gnome_util_home_file</a>                (afile)
<span class="returnvalue">char</span> *              <a class="link" href="libgnome-gnome-util.html#gnome-util-user-shell" title="gnome_util_user_shell ()">gnome_util_user_shell</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
<span class="returnvalue">int</span>                 <a class="link" href="libgnome-gnome-util.html#gnome-setenv" title="gnome_setenv ()">gnome_setenv</a>                        (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *value</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> overwrite</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libgnome-gnome-util.html#gnome-unsetenv" title="gnome_unsetenv ()">gnome_unsetenv</a>                      (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libgnome-gnome-util.html#gnome-clearenv" title="gnome_clearenv ()">gnome_clearenv</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);

#define             <a class="link" href="libgnome-gnome-util.html#g-concat-dir-and-file" title="g_concat_dir_and_file()">g_concat_dir_and_file</a>               (dir,
                                                         file)
#define             <a class="link" href="libgnome-gnome-util.html#g-file-exists" title="g_file_exists()">g_file_exists</a>                       (filename)
#define             <a class="link" href="libgnome-gnome-util.html#g-unix-error-string" title="g_unix_error_string()">g_unix_error_string</a>                 (error_num)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-util-user-home" title="gnome_util_user_home">gnome_util_user_home</a>
#define             <a class="link" href="libgnome-gnome-util.html#g-copy-vector" title="g_copy_vector()">g_copy_vector</a>                       (vec)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-libdir-file" title="gnome_libdir_file()">gnome_libdir_file</a>                   (f)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-datadir-file" title="gnome_datadir_file()">gnome_datadir_file</a>                  (f)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-sound-file" title="gnome_sound_file()">gnome_sound_file</a>                    (f)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-pixmap-file" title="gnome_pixmap_file()">gnome_pixmap_file</a>                   (f)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-config-file" title="gnome_config_file()">gnome_config_file</a>                   (f)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-unconditional-libdir-file" title="gnome_unconditional_libdir_file()">gnome_unconditional_libdir_file</a>     (f)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-unconditional-datadir-file" title="gnome_unconditional_datadir_file()">gnome_unconditional_datadir_file</a>    (f)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-unconditional-sound-file" title="gnome_unconditional_sound_file()">gnome_unconditional_sound_file</a>      (f)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-unconditional-pixmap-file" title="gnome_unconditional_pixmap_file()">gnome_unconditional_pixmap_file</a>     (f)
#define             <a class="link" href="libgnome-gnome-util.html#gnome-unconditional-config-file" title="gnome_unconditional_config_file()">gnome_unconditional_config_file</a>     (f)
</pre>
</div>
<div class="refsect1">
<a name="libgnome-gnome-util.description"></a><h2>Description</h2>
<p>
The functions in this section provide some shortcuts to finding certain file
paths. There are also some functions for manipulating environment variables for
those systems that do not have <code class="function"><code class="function">getenv()</code></code> and similar
functions.
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
   Many of the function in here are now deprecated in favour of similar
   functions in glib. The preferred replacement function in those cases is
   indicated below.
   </p>
</div>
</div>
<div class="refsect1">
<a name="libgnome-gnome-util.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="gnome-is-program-in-path"></a><h3>gnome_is_program_in_path()</h3>
<pre class="programlisting">#define             gnome_is_program_in_path(program)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_is_program_in_path</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Deprecated, use <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-find-program-in-path"><span class="type">g_find_program_in_path</span></a>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>program</code></em> :</span></p></td>
<td>A program name.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if program is not on the path or a string
allocated with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-malloc"><code class="function">g_malloc()</code></a> with the full path name of the program
found.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="g-extension-pointer"></a><h3>g_extension_pointer ()</h3>
<pre class="programlisting">const <span class="returnvalue">char</span> *        g_extension_pointer                 (<em class="parameter"><code>const <span class="type">char</span> *path</code></em>);</pre>
<p>
Extracts the extension from the end of a filename (the part after the final
'.' in the filename).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
<td>A filename or file path.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A pointer to the extension part of the filename, or a
pointer to the end of the string if the filename does not
have an extension.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-util-prepend-user-home"></a><h3>gnome_util_prepend_user_home()</h3>
<pre class="programlisting">#define             gnome_util_prepend_user_home(x)</pre>
<p>
Prepends the home directory of the user to a filename.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
<td>A relative filename in the user's home directory.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A string containing <em class="parameter"><code>x</code></em> with the user's home directory path prepended.
The string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer required.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-util-home-file"></a><h3>gnome_util_home_file()</h3>
<pre class="programlisting">#define             gnome_util_home_file(afile)</pre>
<p>
Similar to <a class="link" href="libgnome-gnome-util.html#gnome-util-prepend-user-home" title="gnome_util_prepend_user_home()"><code class="function">gnome_util_prepend_user_home()</code></a>, except that "/home/fred/.gnome2",
instead of just "/home/fred/" is put on the front.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>afile</code></em> :</span></p></td>
<td>A filename relative to the user's .gnome2 directory.
Returns: A string containing <em class="parameter"><code>afile</code></em> with the user's home directory path  and
"/.gnome2" prepended. The string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer
required.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-util-user-shell"></a><h3>gnome_util_user_shell ()</h3>
<pre class="programlisting"><span class="returnvalue">char</span> *              gnome_util_user_shell               (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Retrieves the user's preferred shell.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A newly allocated string that is the path to the shell.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-setenv"></a><h3>gnome_setenv ()</h3>
<pre class="programlisting"><span class="returnvalue">int</span>                 gnome_setenv                        (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *value</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> overwrite</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_setenv</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Adds "<em class="parameter"><code>name</code></em>=<em class="parameter"><code>value</code></em>" to the environment. Note that on systems without setenv,
this leaks memory so please do not use inside a loop or anything like that.
The semantics are the same as the glibc <code class="function">setenv()</code> (if <code class="function">setenv()</code> exists, it is
used).
</p>
<p>
If <em class="parameter"><code>overwrite</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and the variable already exists in the environment,
then <code class="literal">0</code> is returned and the value is not changed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td>An environment variable name.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>The value to assign to the environment variable.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>overwrite</code></em> :</span></p></td>
<td>If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, overwrite the existing <em class="parameter"><code>name</code></em> variable in the
environment.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<code class="literal">0</code> on success, <code class="literal">-1</code> on error
<em class="parameter"><code>Deprecated</code></em>: 2.30: Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-setenv"><code class="function">g_setenv()</code></a> instead</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-unsetenv"></a><h3>gnome_unsetenv ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gnome_unsetenv                      (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unsetenv</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Removes <em class="parameter"><code>name</code></em> from the environment.
In case there is no native implementation of unsetenv,
this could cause leaks depending on the implementation of
environment.
</p>
<p>
<em class="parameter"><code>Deprecated</code></em>: 2.30: Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-unsetenv"><code class="function">g_unsetenv()</code></a> instead
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td>The environment variable to unset.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-clearenv"></a><h3>gnome_clearenv ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gnome_clearenv                      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_clearenv</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Clears out the environment completely.
In case there is no native implementation of clearenv,
this could cause leaks depending on the implementation
of environment.
</p>
<p>
<em class="parameter"><code>Deprecated</code></em>: 2.30
</p>
</div>
<hr>
<div class="refsect2">
<a name="g-concat-dir-and-file"></a><h3>g_concat_dir_and_file()</h3>
<pre class="programlisting">#define             g_concat_dir_and_file(dir,file)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_concat_dir_and_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-build-filename"><code class="function">g_build_filename()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>dir</code></em> :</span></p></td>
<td>Directory name.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A newly allocated string that is the concatenation of <em class="parameter"><code>dir</code></em> and <em class="parameter"><code>file</code></em>,
with seperators appropriate for the filesystem automatically taken care of.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="g-file-exists"></a><h3>g_file_exists()</h3>
<pre class="programlisting">#define             g_file_exists(filename)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_file_exists</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use g_file_test(<em class="parameter"><code>filename</code></em>, G_FILE_TEST_EXISTS) instead of this
function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>filename</code></em> exists, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="g-unix-error-string"></a><h3>g_unix_error_string()</h3>
<pre class="programlisting">#define             g_unix_error_string(error_num)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_unix_error_string</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strerror"><code class="function">g_strerror()</code></a> instead of this function. Also, note that the
returned string is only valid until the next call to <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strerror"><code class="function">g_strerror()</code></a> or
<a class="link" href="libgnome-gnome-util.html#g-unix-error-string" title="g_unix_error_string()"><code class="function">g_unix_error_string()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>error_num</code></em> :</span></p></td>
<td>A system error number (see C <span class="type">errno</span> documentation for more info).</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A string describing the error code.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-util-user-home"></a><h3>gnome_util_user_home</h3>
<pre class="programlisting">#define             gnome_util_user_home()</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_util_user_home</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-get-home-dir"><code class="function">g_get_home_dir()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>The current user's home directory.</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="g-copy-vector"></a><h3>g_copy_vector()</h3>
<pre class="programlisting">#define             g_copy_vector(vec)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_copy_vector</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Use <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strdupv"><code class="function">g_strdupv()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>vec</code></em> :</span></p></td>
<td>An array of strings. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A copy of the <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated string array.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-libdir-file"></a><h3>gnome_libdir_file()</h3>
<pre class="programlisting">#define             gnome_libdir_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_libdir_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a class="link" href="libgnome-gnome-program.html#gnome-program-locate-file" title="gnome_program_locate_file ()"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
library directory (not the application's directory).</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-datadir-file"></a><h3>gnome_datadir_file()</h3>
<pre class="programlisting">#define             gnome_datadir_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_datadir_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a class="link" href="libgnome-gnome-program.html#gnome-program-locate-file" title="gnome_program_locate_file ()"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
data directory (not the application's directory).</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-sound-file"></a><h3>gnome_sound_file()</h3>
<pre class="programlisting">#define             gnome_sound_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_sound_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a class="link" href="libgnome-gnome-program.html#gnome-program-locate-file" title="gnome_program_locate_file ()"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
sound files directory (not the application's directory).</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-pixmap-file"></a><h3>gnome_pixmap_file()</h3>
<pre class="programlisting">#define             gnome_pixmap_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_pixmap_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a class="link" href="libgnome-gnome-program.html#gnome-program-locate-file" title="gnome_program_locate_file ()"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
pixmap directory (not the application's directory).</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-config-file"></a><h3>gnome_config_file()</h3>
<pre class="programlisting">#define             gnome_config_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_config_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a class="link" href="libgnome-gnome-program.html#gnome-program-locate-file" title="gnome_program_locate_file ()"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
config directory (not the application's directory).</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-unconditional-libdir-file"></a><h3>gnome_unconditional_libdir_file()</h3>
<pre class="programlisting">#define             gnome_unconditional_libdir_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unconditional_libdir_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a class="link" href="libgnome-gnome-program.html#gnome-program-locate-file" title="gnome_program_locate_file ()"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
library directory (not the application's directory).</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-unconditional-datadir-file"></a><h3>gnome_unconditional_datadir_file()</h3>
<pre class="programlisting">#define             gnome_unconditional_datadir_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unconditional_datadir_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a class="link" href="libgnome-gnome-program.html#gnome-program-locate-file" title="gnome_program_locate_file ()"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
data directory (not the application's directory).</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-unconditional-sound-file"></a><h3>gnome_unconditional_sound_file()</h3>
<pre class="programlisting">#define             gnome_unconditional_sound_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unconditional_sound_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a class="link" href="libgnome-gnome-program.html#gnome-program-locate-file" title="gnome_program_locate_file ()"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
sound files directory (not the application's directory).</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-unconditional-pixmap-file"></a><h3>gnome_unconditional_pixmap_file()</h3>
<pre class="programlisting">#define             gnome_unconditional_pixmap_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unconditional_pixmap_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a class="link" href="libgnome-gnome-program.html#gnome-program-locate-file" title="gnome_program_locate_file ()"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
pixmap directory (not the application's directory).</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gnome-unconditional-config-file"></a><h3>gnome_unconditional_config_file()</h3>
<pre class="programlisting">#define             gnome_unconditional_config_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_unconditional_config_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a class="link" href="libgnome-gnome-program.html#gnome-program-locate-file" title="gnome_program_locate_file ()"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
<td>Filename.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
config directory (not the application's directory).</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.16</div>
</body>
</html>